home *** CD-ROM | disk | FTP | other *** search
/ Tech Win 1995 November / CD [TECH_B].bin / tech_b / delphi / trial / disk4 / doc.pak / FORMS.INT < prev    next >
Encoding:
Text File  |  1995-08-08  |  13.6 KB  |  402 lines

  1. {*******************************************************}
  2. {                                                       }
  3. {       Delphi Visual Component Library                 }
  4. {                                                       }
  5. {       Copyright (c) 1995 Borland International        }
  6. {                                                       }
  7. {*******************************************************}
  8.  
  9. unit Forms;
  10.  
  11. {$P+,S-,W-,R-}
  12. {$C PRELOAD}
  13.  
  14. interface
  15.  
  16. uses WinTypes, WinProcs, Messages, SysUtils, Classes, Graphics, Menus,
  17.   Controls;
  18.  
  19. type
  20.  
  21. { Forward declarations }
  22.  
  23.   TScrollingWinControl = class;
  24.   TForm = class;
  25.  
  26. { TControlScrollBar }
  27.  
  28.   TScrollBarKind = (sbHorizontal, sbVertical);
  29.   TScrollBarInc = 1..32767;
  30.  
  31.   TControlScrollBar = class(TPersistent)
  32.   public
  33.     procedure Assign(Source: TPersistent); override;
  34.     property Kind: TScrollBarKind;
  35.     property ScrollPos: Integer;
  36.   published
  37.     property Margin: Word default 0;
  38.     property Increment: TScrollBarInc default 8;
  39.     property Range: Integer default 0;
  40.     property Position: Integer default 0;
  41.     property Visible: Boolean default True;
  42.   end;
  43.  
  44. { TScrollingWinControl }
  45.  
  46.   TScrollingWinControl = class(TWinControl)
  47.   protected
  48.     procedure AutoScrollInView(AControl: TControl);
  49.     procedure ChangeScale(M, D: Integer); override;
  50.     procedure CreateWnd; override;
  51.     procedure AlignControls(AControl: TControl; var ARect: TRect); override;
  52.     property AutoScroll: Boolean default True;
  53.   public
  54.     constructor Create(AOwner: TComponent); override;
  55.     destructor Destroy; override;
  56.     procedure ScrollInView(AControl: TControl);
  57.   published
  58.     property HorzScrollBar: TControlScrollBar;
  59.     property VertScrollBar: TControlScrollBar;
  60.   end;
  61.  
  62. { TScrollBox }
  63.  
  64.   TFormBorderStyle = (bsNone, bsSingle, bsSizeable, bsDialog);
  65.   TBorderStyle = bsNone..bsSingle;
  66.  
  67.   TScrollBox = class(TScrollingWinControl)
  68.   protected
  69.     procedure CreateParams(var Params: TCreateParams); override;
  70.     procedure Resize; dynamic;
  71.   public
  72.     constructor Create(AOwner: TComponent); override;
  73.   published
  74.     property Align;
  75.     property AutoScroll;
  76.     property BorderStyle: TBorderStyle default bsSingle;
  77.     property DragCursor;
  78.     property DragMode;
  79.     property Enabled;
  80.     property Color;
  81.     property Ctl3D;
  82.     property Font;
  83.     property ParentColor;
  84.     property ParentCtl3D;
  85.     property ParentFont;
  86.     property ParentShowHint;
  87.     property PopupMenu;
  88.     property ShowHint;
  89.     property TabOrder;
  90.     property TabStop;
  91.     property Visible;
  92.     property OnClick;
  93.     property OnDblClick;
  94.     property OnDragDrop;
  95.     property OnDragOver;
  96.     property OnEndDrag;
  97.     property OnEnter;
  98.     property OnExit;
  99.     property OnMouseDown;
  100.     property OnMouseMove;
  101.     property OnMouseUp;
  102.     property OnResize: TNotifyEvent;
  103.   end;
  104.  
  105. { TDesigner }
  106.  
  107.   TDesigner = class(TObject)
  108.   public
  109.     function IsDesignMsg(Sender: TControl; var Message: TMessage): Boolean;
  110.       virtual; abstract;
  111.     procedure Modified; virtual; abstract;
  112.     procedure Notification(AComponent: TComponent;
  113.       Operation: TOperation); virtual; abstract;
  114.     procedure PaintGrid; virtual; abstract;
  115.     procedure ValidateRename(AComponent: TComponent;
  116.       const CurName, NewName: string); virtual; abstract;
  117.     property IsControl: Boolean;
  118.     property Form: TForm;
  119.   end;
  120.  
  121. { Ole Helper Delegate }
  122.  
  123.   TWinOleHelper = class(TObject)
  124.   public
  125.     function OnSetFocus (BSet : Boolean) : Boolean; virtual;  abstract;
  126.     procedure OnSetName; virtual;  abstract;
  127.     procedure OnResize; virtual; abstract;
  128.     procedure OnActivate(Active: Boolean); virtual; abstract;
  129.     procedure OnClose(Hide: Boolean); virtual; abstract;
  130.     procedure OnParentNotify (var Message: TWMParentNotify); virtual; abstract;
  131.     procedure OnShowModal (BSet : Boolean); virtual;  abstract;
  132.     procedure OnFormMouseDown(AControl: TControl); virtual;  abstract;
  133.   end;
  134.  
  135. { TForm }
  136.  
  137.   TWindowState = (wsNormal, wsMinimized, wsMaximized);
  138.   TFormStyle = (fsNormal, fsMDIChild, fsMDIForm, fsStayOnTop);
  139.   TBorderIcon = (biSystemMenu, biMinimize, biMaximize);
  140.   TBorderIcons = set of TBorderIcon;
  141.   TPosition = (poDesigned, poDefault, poDefaultPosOnly, poDefaultSizeOnly,
  142.     poScreenCenter);
  143.   TPrintScale = (poNone, poProportional, poPrintToFit);
  144.   TShowAction = (saIgnore, saRestore, saMinimize, saMaximize);
  145.   TTileMode = (tbHorizontal, tbVertical);
  146.   TModalResult = Low(Integer)..High(Integer);
  147.   TCloseAction = (caNone, caHide, caFree, caMinimize);
  148.   TCloseEvent = procedure(Sender: TObject; var Action: TCloseAction) of object;
  149.   TCloseQueryEvent = procedure(Sender: TObject;
  150.     var CanClose: Boolean) of object;
  151.   TFormState = set of (fsCreating, fsVisible, fsShowing, fsModal,
  152.     fsCreatedMDIChild);
  153.  
  154.   TForm = class(TScrollingWinControl)
  155.   protected
  156.     procedure Activate; dynamic;
  157.     procedure ActiveChanged; dynamic;
  158.     procedure ChangeScale(M, D: Integer); override;
  159.     procedure CreateParams(var Params: TCreateParams); override;
  160.     procedure CreateWindowHandle(const Params: TCreateParams); override;
  161.     procedure CreateWnd; override;
  162.     procedure Deactivate; dynamic;
  163.     procedure DefaultHandler(var Message); override;
  164.     procedure DefineProperties(Filer: TFiler); override;
  165.     procedure DestroyWindowHandle; override;
  166.     procedure DoHide; dynamic;
  167.     procedure DoShow; dynamic;
  168.     function GetClientRect: TRect; override;
  169.     procedure Notification(AComponent: TComponent;
  170.       Operation: TOperation); override;
  171.     procedure Paint; dynamic;
  172.     procedure PaintWindow(DC: HDC); override;
  173.     procedure ReadState(Reader: TReader); override;
  174.     procedure Resize; dynamic;
  175.     procedure SetName(const Value: TComponentName); override;
  176.     procedure ValidateRename(AComponent: TComponent;
  177.       const CurName, NewName: string); override;
  178.     procedure VisibleChanging; override;
  179.     procedure WndProc(var Message: TMessage); override;
  180.   public
  181.     constructor Create(AOwner: TComponent); override;
  182.     constructor CreateNew(AOwner: TComponent);
  183.     destructor Destroy; override;
  184.     procedure ArrangeIcons;
  185.     procedure Cascade;
  186.     procedure Close;
  187.     function CloseQuery: Boolean;
  188.     procedure DefocusControl(Control: TWinControl; Removing: Boolean);
  189.     procedure FocusControl(Control: TWinControl);
  190.     function GetFormImage: TBitmap;
  191.     procedure Hide;
  192.     procedure Next;
  193.     procedure Previous;
  194.     procedure Print;
  195.     procedure Release;
  196.     procedure SendCancelMode(Sender: TControl);
  197.     procedure SetFocus; override;
  198.     function SetFocusedControl(Control: TWinControl): Boolean;
  199.     procedure Show;
  200.     function ShowModal: Integer;
  201.     procedure Tile;
  202.     property Active: Boolean;
  203.     property ActiveMDIChild: TForm;
  204.     property Canvas: TCanvas;
  205.     property ClientHandle: HWND;
  206.     property Designer: TDesigner;
  207.     property ModalResult: TModalResult;
  208.     property MDIChildCount: Integer;
  209.     property MDIChildren[I: Integer]: TForm;
  210.     property TileMode: TTileMode default tbHorizontal;
  211.     property DropTarget: Boolean;
  212.     property Helper: TWinOleHelper;
  213.   published
  214.     property ActiveControl: TWinControl;
  215.     property BorderIcons: TBorderIcons default [biSystemMenu, biMinimize, biMaximize];
  216.     property BorderStyle: TFormBorderStyle default bsSizeable;
  217.     property AutoScroll stored IsAutoScrollStored;
  218.     property Caption stored IsForm;
  219.     property ClientHeight write SetClientHeight stored IsClientSizeStored;
  220.     property ClientWidth write SetClientWidth stored IsClientSizeStored;
  221.     property Ctl3D default True;
  222.     property Color stored IsColorStored;
  223.     property Enabled;
  224.     property Font;
  225.     property FormStyle: TFormStyle default fsNormal;
  226.     property Height stored IsFormSizeStored;
  227.     property HorzScrollBar stored IsForm;
  228.     property Icon: TIcon;
  229.     property ImeMode;
  230.     property KeyPreview: Boolean default False;
  231.     property Menu: TMainMenu;
  232.     property ObjectMenuItem: TMenuItem;
  233.     property PixelsPerInch: Integer;
  234.     property PopupMenu stored IsForm;
  235.     property Position: TPosition default poDesigned;
  236.     property PrintScale: TPrintScale default poProportional;
  237.     property Scaled: Boolean default True;
  238.     property ShowHint;
  239.     property VertScrollBar stored IsForm;
  240.     property Visible write SetVisible default False;
  241.     property Width stored IsFormSizeStored;
  242.     property WindowState: TWindowState default wsNormal;
  243.     property WindowMenu: TMenuItem;
  244.     property OnActivate: TNotifyEvent;
  245.     property OnClick stored IsForm;
  246.     property OnClose: TCloseEvent;
  247.     property OnCloseQuery: TCloseQueryEvent;
  248.     property OnCreate: TNotifyEvent;
  249.     property OnDblClick stored IsForm;
  250.     property OnDestroy: TNotifyEvent;
  251.     property OnDeactivate: TNotifyEvent;
  252.     property OnDragDrop stored IsForm;
  253.     property OnDragOver stored IsForm;
  254.     property OnHide: TNotifyEvent;
  255.     property OnKeyDown stored IsForm;
  256.     property OnKeyPress stored IsForm;
  257.     property OnKeyUp stored IsForm;
  258.     property OnMouseDown stored IsForm;
  259.     property OnMouseMove stored IsForm;
  260.     property OnMouseUp stored IsForm;
  261.     property OnPaint: TNotifyEvent;
  262.     property OnResize: TNotifyEvent;
  263.     property OnShow: TNotifyEvent;
  264.   end;
  265.  
  266.   TFormClass = class of TForm;
  267.  
  268. { TScreen }
  269.  
  270.   PCursorRec = ^TCursorRec;
  271.   TCursorRec = record
  272.     Next: PCursorRec;
  273.     Index: Integer;
  274.     Handle: HCURSOR;
  275.   end;
  276.  
  277.   TScreen = class(TComponent)
  278.   public
  279.     constructor Create(AOwner: TComponent); override;
  280.     destructor Destroy; override;
  281.     property ActiveControl: TWinControl;
  282.     property ActiveForm: TForm;
  283.     property Cursor: TCursor;
  284.     property Cursors[Index: Integer]: HCURSOR;
  285.     property Fonts: TStrings;
  286.     property Height: Integer;
  287.     property PixelsPerInch: Integer;
  288.     property Width: Integer;
  289.     property Forms[Index: Integer]: TForm;
  290.     property FormCount: Integer;
  291.     property OnActiveControlChange: TNotifyEvent;
  292.     property OnActiveFormChange: TNotifyEvent;
  293.   end;
  294.  
  295. { TApplication }
  296.  
  297.   THintInfo = record
  298.     HintControl: TControl;
  299.     HintPos: TPoint;
  300.     HintMaxWidth: Integer;
  301.     HintColor: TColor;
  302.     CursorRect: TRect;
  303.     CursorPos: TPoint;
  304.   end;
  305.  
  306.   TMessageEvent = procedure (var Msg: TMsg; var Handled: Boolean) of object;
  307.   TExceptionEvent = procedure (Sender: TObject; E: Exception) of object;
  308.   TIdleEvent = procedure (Sender: TObject; var Done: Boolean) of object;
  309.   TShowHintEvent = procedure (var HintStr: string; var CanShow: Boolean;
  310.     var HintInfo: THintInfo) of object;
  311.   TWindowHook = function (var Message: TMessage): Boolean of object;
  312.  
  313.   TApplication = class(TComponent)
  314.   protected
  315.     procedure WriteComponents(Writer: TWriter); override;
  316.   public
  317.     constructor Create(AOwner: TComponent); override;
  318.     destructor Destroy; override;
  319.     procedure ControlDestroyed(Control: TControl);
  320.     procedure CancelHint;
  321.     function HelpContext(Context: THelpContext): Boolean;
  322.     function HelpCommand(Command: Word; Data: Longint): Boolean;
  323.     function HelpJump(const JumpID: string): Boolean;
  324.     procedure CreateForm(FormClass: TFormClass; var Reference);
  325.     procedure Run;
  326.     procedure Terminate;
  327.     procedure ProcessMessages;
  328.     procedure HandleMessage;
  329.     procedure HookMainWindow(Hook: TWindowHook);
  330.     function MessageBox(Text, Caption: PChar; Flags: Word): Integer;
  331.     procedure Minimize;
  332.     procedure NormalizeTopMosts;
  333.     procedure Restore;
  334.     procedure RestoreTopMosts;
  335.     procedure BringToFront;
  336.     procedure HandleException(Sender: TObject);
  337.     procedure ShowException(E: Exception);
  338.     procedure UnhookMainWindow(Hook: TWindowHook);
  339.     property Active: Boolean;
  340.     property DialogHandle: HWnd;
  341.     property ExeName: string;
  342.     property Handle: HWnd;
  343.     property HelpFile: string;
  344.     property Hint: string;
  345.     property ShowHint: Boolean;
  346.     property HintColor: TColor;
  347.     property HintPause: Integer;
  348.     property Icon: TIcon;
  349.     property MainForm: TForm;
  350.     property Terminated: Boolean;
  351.     property Title: string;
  352.     property OnActivate: TNotifyEvent;
  353.     property OnDeactivate: TNotifyEvent;
  354.     property OnException: TExceptionEvent;
  355.     property OnIdle: TIdleEvent;
  356.     property OnHelp: THelpEvent;
  357.     property OnHint: TNotifyEvent;
  358.     property OnMessage: TMessageEvent;
  359.     property OnMinimize: TNotifyEvent;
  360.     property OnRestore: TNotifyEvent;
  361.     property OnShowHint: TShowHintEvent;
  362.   end;
  363.  
  364.   TWndMethod = procedure(var Message: TMessage) of object;
  365.  
  366. { Global objects }
  367.  
  368. var
  369.   Application: TApplication;
  370.   Screen: TScreen;
  371.  
  372. const
  373.   Ctl3DBtnWndProc: Pointer = nil;
  374.   Ctl3DDlgFramePaint: function(Window: HWnd; Msg: Word; wParam: Word;
  375.     lParam: Longint): Longint = nil;
  376.   Ctl3DCtlColorEx : function(Window: HWnd; Msg: Word; wParam: Word;
  377.     lParam: Longint): Longint = nil;
  378.   HintWindowClass: THintWindowClass = THintWindow;
  379.  
  380. function GetParentForm(Control: TControl): TForm;
  381. function ValidParentForm(Control: TControl): TForm;
  382.  
  383. function DisableTaskWindows(ActiveWindow: HWnd): Pointer;
  384. procedure EnableTaskWindows(WindowList: Pointer);
  385.  
  386. function MakeObjectInstance(Method: TWndMethod): Pointer;
  387. procedure FreeObjectInstance(ObjectInstance: Pointer);
  388.  
  389. function IsAccel(VK: Word; const Str: string): Boolean;
  390.  
  391. procedure Subclass3DWnd(Wnd: HWnd);
  392. procedure Subclass3DDlg(Wnd: HWnd; Flags: Word);
  393. procedure SetAutoSubClass(Enable: Boolean);
  394. function AllocateHWnd(Method: TWndMethod): HWND;
  395. procedure DeallocateHWnd(Wnd: HWND);
  396. procedure DoneCtl3D;
  397.  
  398. function KeysToShiftState(Keys: Word): TShiftState;
  399. function KeyDataToShiftState(KeyData: Longint): TShiftState;
  400.  
  401. implementation
  402.